Skip to content

docs(planning): defer Zensical cutover with beta/1.0 revisit trigger#36

Merged
lesnik512 merged 1 commit into
mainfrom
docs/defer-zensical-cutover
Jul 5, 2026
Merged

docs(planning): defer Zensical cutover with beta/1.0 revisit trigger#36
lesnik512 merged 1 commit into
mainfrom
docs/defer-zensical-cutover

Conversation

@lesnik512

Copy link
Copy Markdown
Member

What

Records the Zensical evaluation as a planning/deferred.md item so the "wait for beta/1.0" decision and its concrete re-check list survive on main, independent of any spike branch.

Why

We revisited the old spike/zensical reference. Findings:

  • Zensical is unchanged since the spike — still 0.0.46 (2026-06-21, latest release); no beta/1.0.
  • Feasibility re-confirmed on 2026-07-05 against today's site: a zensical.toml mirror of mkdocs.yml + a one-block overrides/main.html tweak (dedupe the homepage <title> by title text, since Zensical alpha leaves page.is_homepage undefined) builds cleanly under both uvx zensical@0.0.46 build and mkdocs build --strict, with identical title/og:title output.
  • Known gaps keep it deferred, captured as the revisit trigger:
    1. page.is_homepage (+ siblings) not exposed to custom templates.
    2. validation parity for strict docs repos (e.g. faststream-outbox): omitted_files/orphaned-page detection and absolute_links have no documented Zensical equivalent; several Zensical validation keys are still deprecated. --strict, invalid_links, invalid_link_anchors do map.
    3. classic variant fidelity after the theme rewrite stabilizes.

The feasibility spike branch was not kept; mkdocs remains the live builder.

Verification

  • just check-planning — OK

Record the Zensical evaluation as a deferred item so the "wait for beta/1.0"
decision and its concrete re-check list (page.is_homepage exposure, validation
parity for strict docs repos, classic-variant fidelity) survive on main. The
0.0.46 feasibility spike was validated on 2026-07-05 but not kept as a branch;
redo the port from mkdocs.yml when revisiting.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@lesnik512 lesnik512 merged commit 794cd02 into main Jul 5, 2026
1 check passed
@lesnik512 lesnik512 deleted the docs/defer-zensical-cutover branch July 5, 2026 08:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant